package com.caregiver.watch.business.data.dao;

import com.caregiver.watch.business.data.model.po.HealthSleepDisplay;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.time.LocalDateTime;
import java.util.List;

/**
 * 睡眠展示数据访问接口
 */
@Mapper
public interface HealthSleepDisplayDao {
    
    /**
     * 插入睡眠展示数据
     * 
     * @param healthSleepDisplay 睡眠展示数据实体
     * @return 影响行数
     */
    int insert(HealthSleepDisplay healthSleepDisplay);
    
    /**
     * 根据ID更新睡眠展示数据
     * 
     * @param healthSleepDisplay 睡眠展示数据实体
     * @return 影响行数
     */
    int updateById(HealthSleepDisplay healthSleepDisplay);
    
    /**
     * 根据ID删除睡眠展示数据
     * 
     * @param id 主键ID
     * @return 影响行数
     */
    int deleteById(Long id);
    
    /**
     * 根据ID查询睡眠展示数据
     * 
     * @param id 主键ID
     * @return 睡眠展示数据实体
     */
    HealthSleepDisplay findById(Long id);
    
    /**
     * 根据用户ID和时间范围查询睡眠展示数据
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 睡眠展示数据列表
     */
    HealthSleepDisplay findLatest(@Param("userId") Long userId,
                                                     @Param("deviceUuid") String deviceUuid,
                                                     @Param("startTime") LocalDateTime startTime, 
                                                     @Param("endTime") LocalDateTime endTime);
    
    /**
     * 根据用户ID和设备UUID查询最新的睡眠展示数据
     * 
     * @param userId 用户ID
     * @param deviceUuid 设备唯一标识
     * @return 睡眠展示数据实体
     */
    HealthSleepDisplay findLatestByUserIdAndDeviceUuid(@Param("userId") Long userId, 
                                                      @Param("deviceUuid") String deviceUuid);

    /**
     * 根据用户ID和时间范围查询睡眠展示数据
     *
     * @param userId 用户ID
     * @param deviceUuid 设备唯一标识
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 睡眠展示数据列表
     */
    List<HealthSleepDisplay> queryByUserIdAndTimeRange(@Param("userId") Long userId,
                                                        @Param("deviceUuid") String deviceUuid,
                                                        @Param("startTime") LocalDateTime startTime,
                                                        @Param("endTime") LocalDateTime endTime);
}
